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COMMAND 


FUNCTION 


NOTES 


(A) 




CURSOR LEFT 


Left-arrow also 


(S) 




CURSOR RIGHT 


Right-arrow also 


(U) 


. 


CURSOR UP 


Up-arrow also 


(Z) 




CURSOR DOWN 


Down-arrow at so 


(Q) 




CURSOR HOME 




CN) 




CURSOR to FILE END 




(B) 




CURSOR TO FILE BEGINNING 




<E> 




SCROLL UP (Forward) 




(X) 




SCROLL DOWN (Backyards) 




(D) 




DELETE CHARACTER 




(F) 




INSERT CHARACTER 




(Y) 


»'■ 


DELETE LINE 




(G) 


£$r 


INSERT LINE 




CT) 




ERASE to END of LINE 




(U) 




DELETE BLOCK 




<H> 




INSERT BLOCK 




(L) 




FORM FEED 


Shift Down-Arrow 


(V) 




STRING SEARCH 




(C) 




CONTINUE SEARCH 




(R) 




REPEAT FUNCTION 




(K) 




SUB-SYSTEM COMMAND TABLE 




(P) 




PRINT 




(0) 




EXIT SYSTEM "i,m .' gg^ - 


Jumps to BASIC 
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RETURN to MAIN SYSTEM 




ENTER 




TERMINATE RECORD (LINE FEED) 




CLEAR 




CURSOR to BEGINNING of LINE 




SHIFT 


BREAK 


LOWER-CASE ENTRY ON/OFF 




SHIFT 


CLEAR 


UNDERLINE 


With Lower-case 1 


SHIFT 


UP-ARROW 


SAME as BREAK 




SHIFT 


DOWN-ARROW 


TERMINATE PAGE (FORM FEED) 




SHIFT 


LEFT-ARROW 


BACKSPACE and ERASE CHARACTER 



SHIFT RIGHT-ARROW CURSOR 8 SPACES RIGHT (TAB) 
CONTROL or SHIFT CREATE CONTROL CHARACTER 
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SHIFT if no lower-case ki' 
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TAPE READER 


R 


TAPE WRITER 


W 


TAPE VERIFY 


V 


WORD NUMBER 


X 


RCRD NUMBER 


Y 


CLER AA CUR 


CAA 


CLER A3 CUR 


CAB 


CLER SYSTEM 


CLR 



RGHT 


JUSTFY 


JO-1 


LINE 


SPACNG 


S1-5 


PAGE 


SPACNG 


A2-20 


PAGE 


LENGTH 


G1-72 


LEFT 


MARGIN 


MO-100 


PAGE 


NUMBER 


N1-255 


PRNT 


LENGTH 


PO-255 


LINE 


LENGTH 


L25-125 
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INTRODUCTION -^ '. .v 
% v _ ; 

The Electric Pencil is a Character Oriented Uord Processing System. This . ,''iV"4" '• 

oeona that text is entered as a continuous string of characters and 'Ja "* ^Hvii 

aanipulated as such. This c I Lous the user enormous freedom and case in tfce ' "[ 

r:overaent and hand Li no of text. Since lines ore not delineated, any number j,.-. 

of characters, words, lines or paragraphs nay be inserted or deleted j$ 

anywhere in the text. The entirety of the text shifts and opens up or f'\ 
closes as needed in full view of the user. The typing of carriage returns ' V: : 

as well as word hyphenation is not required since each Una. of text is v: 

formatted automatically. As text is typed in and the erid of a screen line ';; .; 

is reached, a partially completed word is shifted to the beginning of the ] s ' ; "; 

following line. Whenever text is inserted or deleted, existing text is ;.^ 

pushed down or pulled up in a wrap around fashion. Everything appears on . ; . ; ; 

the video display screen as it occurs thereby eliminating any guesswork. f; 

Text may be reviewed at will by variable speed scrolling both in the ^ 

forward and reverse directions. :£•■ 

By using the search or the search and replace function, any string of ;;!>: 

characters aay be located and/or replaced with any other string of ;;ii' 

characters as desired. Specific sets of characters within encoded strings £$. 

may also be located and used in creating selective Railing lists. S 

When text is printed. The Electric Pencil automatically inserts carriage i ! |; 

returns where they are needed. Numerous combinations of line Length, Page £{• 

Length, Character Spacing, Line Spacing end Page Spacing allow for any foro !$■ 

to be handled. Right Justification gives right-hand aargins that are even. !>! 

Pages aay be numbered as well as titled. j;''- ; 

', l t'' "■ 

To take full advantage of The Electric Pencil for the TRS-SO., the louer £■' 

case modification kit should be installed in your TRS-30. This f-'-' 

nodif icaticn^ described in detail near the end of this oanual, allows tower li-v 

case characters to be entered froa the keyboard and displayed on the 'y'h 

screen. However, this modification does require opening the case of the 5': 

computer and will void the warranty. If you prefer not to install this ly 

kit? The Electric Pencil will still operate, but with upper case characters f^ 

only. [j? 

The Electric Pencil has been adapted to the TKS-30 by Snail Systea Software '«' 

of Koubury Pork, Califprnia. " '^ 
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SYSTEM HARDUAKS 3EGUX3£,-;ENTS 

oi'ratVTtaH'eetr.e P £, l°UdV ^^ ""-"P"" «"« » r.,u1r.d to 
k ^v-t 111 v. u^eccric Pencil word Processing Systera: 

TR3-80 Level I or Level II Microcomputer 

16i< of memory (.y.inimurj) 

Radio Shack Interface Box and Printer or 

Small system Karduare TRS232 Interface and any rs-232 Prirter 

i-ouer case nodi fi cat ion kit (optional) 

Cassette Recorder 



USING THIS RANUAL 



i^ouing full well that instruction nanuals can be rather tedious this on- 
w«>s assemoled with ease of application as its nain criteri' t^' * > 

not ntended t0 be a course but rather ;^ Ho ;;/ r ^ : s f 

^lecmcPencU Uord Processing System. Uithin a fe« hou rs anyone^ 
be ^pe" 'at ft'' "V? ^ ^T^ PencU 3nd in l *» < h - « fe«X on 



THE BEST UAY TO LEARN TO OPERATE THIS SYSTER IS TO 



USE IT i « » 



j;p x«x, ^^r-^i-r'^^jr. ,rsv; 
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GLOSSARY 



Any words that may be new to the reader are included in this glossary. 
Commonly used words that msy have a special meaning in the context of word 
processing are also included. Words that appear uithin definitions that 
are also defined in the glossary are capitalized. If any of The text seems 
vague while reading this manual, simply go back to the last point in the 
text that was fully understood, read forward to the word that was not fully 
understood, and look it up. Try it, it works! ., 

BLOCK 

Any amount of text as small as one CHARACTER or as large as an entire FILE. 
A BLOCK may be a WORD or a sentence or a paragraph or a group of 
paragraphs. 

C HARACTER 

Any^ letter, number, punctuation or symbol appearing on the VIDFO DISPLAY 
SCRtEN or keyboard. 

CLEAR 



The action of erasing or uiping out or deleting text from the face of the 
VIDEO DISPLAY SCREEN or from the FILE AREA. 

CO MMAND 

A CONTROL CHARACTER or normal letter CHARACTER that is used to tell The 
Electric Pencil what to do. 

CONTROL 

A keyboard key that is used together with any letter key to create a 
CONTROL CHARACTER. Unmodified TRS-80's (upper-case only) use the shift key 
to create control characters. When the TRS-30 is modified for Lower-case 
entry and display, a separate CONTROL key is added as part of the 
lower-case modification kit. 

CONTROL CHARACTER 

A non-printing ASCII character used to tell The Electric Pencil what to do. 

CURSOR 

A transparent white block uhich appears on the VIDEO DISPLAY SCREEN and is 
used to indicate the CHARACTER or space about to be typed, moved, inserted 
or deleted. 
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GLOSSARY 

DEFAULT VALUE 

by^hfuserf ""^ "" ^ ^^ ^^ ^^^ m value is specified 

DELETE 

The process of removing a CHARACTER, a space, a Line or a BLOCK n* *„vt 
from the VIDEO DISPLAY SCREEN. > • d une or a BL0 ^ o, cext 

FILE 



|he entirety of text that has been entered onto the VIDEO DISPLAY SCREEN 
and suosequently into the memory of The Electric Pencil ML tL te-t 
resident within the system at any given time is called a FILE 



FILE AREA 



PenciYTs TirlTZLlT ^J^' ^'^ ^ the FILE " Whe " The El <^ic 
Pencil is first turned on, this area is automatically determined bv tho 

system by examining all available contiguous (adjoin ngT memory and 
claiming it. Whenever the FILE AREA is full, the message "file AREA n 
will appear on the screen. A ' ULL 



F0RP1 FEED 



fhft^^rth^n;:? IT th Th fU r th3t yUL "^ the Printer t0 ad — ^ 
top of chc next p a ge. The character on the screen is the down arrow. 



JUSTIFICATION 



JiJL^M^LtiSr SPaC " Ulthl " a M " e ° f te " - °"<" to create an 



LIK2 FEED 



• A character in the file that uill terminate a line and cause a now lin~ tn 
begin. ,he character on the screen is a left arrow and is typed In^o the 
Tile using the ENTER key. ypea 1rit0 Lne 



PAGE 



Sixteen lines of text appearing on the VIDEO DISPLAY SCREEN Hay be anv 
number of lines of text when referring to a printed PAGE. 



PAGEMATION 



The process of automatically numbering pages. 



lS»2 ELECTRIC PENCIL 
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PHILTER . 



An electric typewriter that prints text from The Elettric Pencil FILE A«SA 
onto paper. iv. s .u.«. A i_.u ^..^ 
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PHZOT VALUE 

A value assigned to a printing function by the user or by the system. This 
Value mil determine Line Length, PAGE Length, Line Spacing, tic. 

READ 

^, e r a "i°" °f m0V ^ g a FILE fr «» a cassette tape and inserting it into the 
i-iLc *REA ( playing" a tape into the computer). 

RECORD 



Any BLOCK of text that is terminated by an ENTER (ENTER key) or a FORM 

F-r" i ofrn^l *** "V* Sh ? Pt ,7? one CHARACTER or as long as the entire 
3-*i_t. A RECORD is most nearly like a paragraph. 

-a 

SCROLL 

Ji't^Mn ° f * tJ l e IT a ° Vin ? UP ° r d0lJn th0 UIDE0 ^SPLAY SCREEN. Kore 
than 16 lines of text (one PAGE) must exist in the FILE for this action to 



STRING 

Any consecutive grouping of letters, spaces, numbers, punctuation or 
symools. In this system, a STRING may be anywhere from 1 to 40 characters 

VIDEO DISPLAY SCREEN 

The electronic display unit of the TRS-SO. Also called a CRT (Cathode Ray 
* fuoe) or monitor or simply screen. 7 

Any number of characters with at least one space at either end. A WORD may 
be as short as one CHARACTER or as long as one line. 

USSTE 

The action of moving text from the FILE AREA and recording it onto cassette 
tape ('recording" a tape from the computer). 
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Tiiiz. ELECTRIC p^CJCIL OPERATOR'S 



TAPS LOADING INSTRUCTIONS 

The Electric Pencil is furnished on cassette using Small System Software's 
Two-Level tape format. Two-Level tapes are designed to load and run on 
either LEVEL I or LEVEL II TRS-80 computers. To accomplish this, all of 
the keyboard routines, video routines and tape cassette routines are 
included as part of The Electric Pencil. In other words, once a two-level 
tape has been loaded, none of the routines in BASIC are used. This not 
only allows loading into either type of TRS-80, it prevents your two-level 
programs from becoming obsolete, since they will run even if new versions 
of BASIC are released. 

Two-level tapes consist of a short tape loading routine which is recorded 
at the LEVEL I rate of 250 baud. This is followed by the main program 
which is recorded at the LEVEL II rate of 500 baud. The main program is 
recorded to load into LEVEL II machines using the SYSTEM command, which is 
designed to load machine language tapes. The short loader at 250 baud is a 

^special version of the SYSTEM command which is designed to run on LEVEL I 

Machines. 



LEVEL I LOADING INSTRUCTIONS 

Load The Electric Pencil the same as any CLOAD tape. Start the tape at the 
beginning by using the CLOAD (or CL.) command. When the tape starts to 
load, the two stars will appear "in the upper left corner of the screen. 
After about 5 seconds, the screen will clear (except for the cursor), 
indicating that the bootstrap loader is running. After about 4 more 
seconds, two stars will appear in the upper right corner of the screen, 
indicating that the main program is beginning to load. The right hand star 
of this pair will blink about every 4 seconds, or after each 256 byte block 
of code is loaded. If a tape error is detected, the WHAT? message will 
appear. When the tape is finished loading, the program will automatically 
begin running. 



LEVEL II LOADING INSTRUCTIONS 



Load two-level tapes using the SYSTEM command. Type SYSTEM and press 
E?JiER. A star and question mark will appear (*?) . Prepare the tape and 
recorder to load the tape. Type the program name, which is PENCIL. l-Jhen 
the ENiER key is pressed, the cassette will start running. The LEVEL I 
loader on the tape will be ignored by the LEVEL II computer. When the main 
program is reached on the tape, two stars will appear in the upper right of 
the screen. The right hand star will blink about every 4 seconds. If a 
tape error is detected, the left star will be replaced by a C, indicating a 
Checksum error, and the machine will usually hang up, requiring the reset 
button to be used. When a successful load is achieved, the star and 
question mark will return. At this point, you must type a slash (/) and 
ENTER. The Electric Pencil will now start running. 
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IN CASE OF DIFFICULTY 

If your tape fails to load, first be sure the tape is recorded. If you 
cannot hear your tapes while they are loading, pull the plug and listen. 
Write down the tape counter settings where the sound begins and ends. 
Please also note that there is a second copy of the program on each 
cassette, which starts about 10 seconds after the end of the first copy. 
Se sure to write down the numbers for both copies. 

Nearly all tape loading difficulties can be resolved by adjusting the 
volume control on your tape recorder. Our tapes load reliably using the 
Radio Shack CTR-41 recorder with the tone control in the high 'position and 
the volume control set betueen 6 and 7 1/2. Start with your control set 
for 7 1/2. If this doesn't work for you, try lowering the volume control by 
about 1/4 number. Level II tapes are very touchy; a change of 1/4 in 
volume can make a major difference in performance. Continue this procedure 
until you reach 6 or slightly under on your volume control. Usually volume 
control problems show up very quickly, thus this procedure should not take 
t!o long. Experiment with your tape, and when it loads, write down the 
setting on the cassette label. Be sure to try both copies before giving 
up. If you are unable to load either copy of your program at any volume 
level, contact your dealer for a replacement cassette. 

We suggest that you modify your tape recorder so that you can hear it 
during record or playback operations. It is a simple matter to place a 
resistor (about 100 ohms; experiment to determine the prope/ volume level) 
across the speaker disable switch inside the recorder. You will then be 
able to better judge the proper volume level for your tapes, will be able 
to tell when the tape starts and ends, and can sometimes hear a tape 
dropout problem when it occurs. 
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GETTING STARTED 



operator's ;-;a:oual p~g£ « 



When you have successfully loaded The Electric Pencil and the program is 
running, the screen will clear and display: 

LOWER CASE KIT INSTALLED? (Y/N) 

The lower-case kit must include both a control key and a memory chip for 
the screen memory, as" described near the end of this document. Addition of 
the memory chip alone is not sufficient. If you have the lower-case kit, 
type Y, otherwise type N. If you type Y without the kit in >he computer, 
The Electric Pencil will not run properly, and you must reload your 
cassette to correct the error. (It is OX to type N if you have the kit 
installed). 

A,.fter you type Y or N, or any time the system is cleared, the screen will 
iPlear and display: 

THE ELECTRIC PENCIL (C) 1973 MICHAEL SHRAYER 

Depressing any key on the keyboard will clear the screen and a blinking 
white cursor will appear in the HOME or upper left-hand corner of the 
screen. A file may now be started by typing in the desired text. If you 
have the lower-case kit installed, type SHIFT-BREAK to enable lower-case 
entry. A second SHIFT-BREAK will return the keyboard to upper-case only. 
Any key held down for more than 1/2 second will repeat at a rate of about 
10 characters per second. Note that ENTER is not used at the end of a line 
and that any partially completed word that doesn't fit on the line will be 
brought down to the next line. Typing can proceed normally until the end 
of a paragraph is reached. At this point ENTER should be typed to 
terminate the paragraph or record. A left-arrow will appear on the screen 
at the end of the line, and the cursor will advance to the beginning of the 
next line. Any additional ENTERS will insert blank lines after the record. 
If this is to be the end of a page, a FORM FEED (shift down-arrow or 
control-L) is typed. Before continuing with this manual, the user is 
advised to try this in order to get a "feel" of how text is entered into 
The Electric Pencil file area. 

It is recommended that sentences begin at the extreme left margin since 
indentation can not be guaranteed unless a line is terminated by an ENTER. 
Whenever a specific number of spaces within a line are essential, the line 
must be terminated by an ENTER. This is because lines are not delineated 
and may be broken up at any point during printing. Exactly where a line 
will end is determined by the line length that is selected by the user just 
prior to printing. However, by assuming manual control of The Electric 
Pencil during printing, indentation is possible. 

Experimentation and imagination will bring about almost any desired results 
in the final printing of text. 



for unmodified computers) and the specified alphabetic character" key oe 
depressed simultaneously. Control Character Commands (except ENTER and 
rOR'A FEED) will not appear on the video display screen. In this text, all 
reverences to Control Character Commands shall be designated by enclosing 
tr.era in parentheses, e.g. (A), (e) . Standard keyboard characters when 
referenced shall be enclosed in brackets, e.g. CAD, CSj, C5D, etc. 
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FUNCTION 



NOTES 



(A) 
(S) 

<w> 

(2) 
(G) 
(.M) 
(3) 
<E) 
(X) 
(D) 
(F) 
(Y) 

" CD 
(U> 
<H) 
<L) 
<H) 
(V) 
(C) 
(R> 
CO 
(?) 
(0) 
(I) 
(J) 



CURSOR 

CURSOR 

CURSOR 

CURSOR 

CURSOR 

CURSOR 

CURSOR 

SCROLL UP 

SCROLL 

DELETE 

INSERT 

DELETE 

INSERT 

ERASE to END of LIME 

DELETE BLOCK 

INSERT SLOCK 

FORM FEED 

Same as ENTER 

STRING SEARCH 

CONTINUE SEARCH 

REPEAT FUNCTION 

SUB-SYSTEH COKMAND TAB 

PRINT 

EXIT SYSTEM 

Reserved 

Reserved 



LEFT 

RIGHT 

UP 

DOWN 

HOME 

to FILE END 

TO FILE BEGINNING 

(Forward) 
DOWN (Backwards) 
CHARACTER 
CHARACTER 
LINE 
LINE 



Left-arrou also 
Right-arrow also 
Up-arrow also 
Down-arrow also 



Shift Down-Arrow also 



Jumps to BASIC 






SHIFT BREAK 
SHIFT CLEAR 
SHIFT UP-ARROW 
SHIFT DOUN-ARROU 
SHIFT LEFT-ARROU 
SHIFT RIGHT-ARROW CURSOR 8 SPACES RIGHT (TAB) 
►CONTROL or SHIFT CREATE CONTROL CHARACTER 



RETURN to RAIN SYSTEM 
TERMINATE RECORD (LINE FEED) 
CURSOR to BEGINNING of LINE 
LOUER-CASE ENTRY ON/OFF 
UNDERLINE 
SAME as BREAK 
TERMINATE PAGE (FORM FEED) 
BACKSPACE and ERASE CHARACTER 



With lower-case kit only 



SHIFT if 



no lower-case kit 



CONTROL CHARACTERS were selected for location and convenience rather than 
signvncance as shall be discussed. 
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Notice that the most often used Cursor Hot ion Cor-mand keys are clustered at 
the Left of the keyboard. The keys that move the cursor UP and D0UN, and 
to the LEFT and RIGHT form a diamond that conveniently points in these 
directions. The <Q) in the upper Left hand corner represents NOHE, which 
is also the upper left corner of the video display screen. You may also 
use the four arrou keys to move the cursor if you desire. If you hold doun 
a cursor motion key (or any other key), it will begin to repeat at about 10 
characters per second after a 1/2 second delay. This feature may be used 
to rapidly position the cursor anywhere on the screen. 

HOME (G) (U> UP (E) SCROLL UP 

A 
/ \ 

/ \ 
» LEFT (A) / \ (S) RIGHT 

\ / 

\ / 

\ / 

\/ 

(Z) DOWN (X) SCROLL DOWN 

MOVING THE CUR SOR TO THE BEGINNING A?JD END OF FILE 

The (3) and (N) are not as heavily used as the above cursor cowhands and 
therefore are not located in the same area. (B) returns the curse- to the 
beginning of the file and (N) moves the cursor to the end of the file. 

SCROLLING AND DISPLAY CONTROL 

SCROLLING is the action of the text moving up or doun the video display 
screen. Flore than 16 lines of text (one page) must exist in the file for 
this action to occur. The (E) and (X) keys scroll the screen up and doun 
respectively. The cursor will disappear from the screen during a scroll. 
Scrolling speed may be controlled by typing the numerals CI 3 through LSI 
while scrolling. [13 is the fastest speed, and LSI is the slowest. 
"Further control is .provided by the SPACE BAR, which temporarily halts the 
scroll. Continued depressions of the SPACE BAR trill scroll one line at a 
tine in the direction previously selected. The ENTER key uill continue the 
scroll after it has been halted by the SPACE BAR. Uhen the end of the file 
is reached or when BREAK is used, the scroll uill stop completely, the 
cursor uill re-appear on the screen, and total system control will return 
to the user. 



fHE ELECTRIC PEKCIL 
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DELETE CHARACTER 

(D) is used to deU-l, a character that exists in a body of text Thi cursor 

s s Wy placed over the character to be deleted, and (D> is t,peo. The 

1S S1, »' u y ^ dL ' fnu . pH . th „ riir «. nr one oosition. Multiple deletions 

entire text then moves towards tne cursor on, ^usiuiu 

are also possible from any location by deleting one character or space at a 
time. 



INSERT CHARA CTER 

The Electric Pencil is normally in an over-write mode. This means that any 
character typed uill appear wherever the cursor is located I; there , is 
already a character at the current cursor position, the new character typed 
w 11 replace the existing one. By typing CF>, the Insert Mode is entered 

he size of the cursor will increase to warn the user that the system i 
now <n insert Mode. While in the Insert Mode any character typed will 
-M.Vomatically shift the entire text to the right and insert the new 
chtrac?er into the cursor position. Typing (F) or leaving the current line 

• L exit the insert Rode and the cursor will assume Us normal form When 
the end of a line is reached, while in the Insert Mode Cor even while in 

he normal over-write mode), an entire line will be opened up to allow for 
additional character insertion. If a line is only partially filled (D, 
will pull up the rest of the text to the cursor. Doing the above actions 
will demonstrate more clearly what actually happens far better tuar. this 
manual can. .* 



DELETE L INE 

(Y) will delete whatever line the cursor is currently on. 



INSERT LINE 



(G) will move the line that the cursor is currently on down one and the 
cursor will assume a position at the beginning of tne empty line Text may 
now be typed in as needed and when the end of the line is reached, another 
(G) will automatically be entered by the system allowing the user to 
continue entering text without interruption. 



ERASE TO END OF LINE 



(T) erases all text from the current cursor position to the end of the 
current line. 



ELECTRIC PENCIL 
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SLOCK MOV E M EN T 

A block is defined as any amount of text as small as o.v ^aracter ur as 
Large as an entire tile. It may be a word or a sentence or a paragraph or 
a group of paragraphs. In order to move a block of text to anot «•., part o , 
the file or to delete a block of text, it must first be marked. Tae 
character used to mark the boundaries of a block is an wp-orrow This 
character is also called a "marker". To mark the boundaries Oi a b.ock, 
the cursor is placed over the first character of the text desired arm then 
the SHIFT UP-ARROU keys are depressed. The action will oe the same as i ._ 
the Insert Mode was entered. The text will shift right and the marKer 
will be placed. The cursor should now be moved to one character boyond the 
end of the block of text desired and similarly marked. Exactly two markers 
must be used- otherwise, a MARKER ERROR message will appear on the video 
display screen when a move is attempted. BREAK is used when this occurs to 
return to the system so that the user can place the markers correctly. 



arkers ma; 



be 



deleted using the search function 



Mark e r s a r 
no t be- placed 



automatically deleted during a block delete. Markers shouu 
after a LF (back-arrow) character on the screen. Instead, p. ire . ae marker 
at the beginning of the following line. This will prevent the appearance 
of two markers on the screen. 



DELETE BLOCK 



(U) will delete a blick that has been correctly marke^ 
The block markers are alv.o deleted during this anion. 
incorrectly m„r V M or not marked at all, "MARKER ERROR w, 
video display screen. 
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IN SERT B LOCK 

(H) is used to insert a correctly marked block at any ,e Um. t -! cursor 
position and may be repeated as often as desired. "MARKER H.10R"«il 
appear on the video display screen if an attempt is made to mc-vr a block 
into itself or if more or less than two markers exist in the fil.-. 



EN TER, FORM FEED , TA B and CLEA R < RETURN )_ 

ENTER is used to terminate a record or to place an ^rnpty I : . n* between 
records. When ENTER is typed, a left-arrow will app.-ar n cursor wsiuon 
and the cursor will advance to the beginning of the next n.v. K/kM F a D 
(SHIFT DOWN-ARROW or <D) is also used to trrminatp a record., but *hen it 
is encountered during printing, the printer will ad,an,e the p,n,e, to the 
too of the next page. TAB (SHIFT RIGHT-ARROW) may he used .,-. ar, express 
key to quickly move across the screen as well as tor its normal function o, 
tabbing 8 spaces to the right. CLEAR moves the cursor to the oeg.nning or 
the current line (carriage return). 
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STR ING SEARCH 

The search function is used to Locate any string of characters that may 
exist in the file from the current cursor position to the end of the file. 
(V) clears the video display screen and then displays: 

SEARCH STRING? 

The character string desired followed by an ENTER is then typed in by the 
user. The maximum string length is 40 characters. The first occurence of 
the string from the cursor position forward will appear as the tip line on 
the video display screen. The search may be continued by typing control 
character (C) . Each subsequent "find" will also appear as the top line on 
the screen. When the end of the file is reached or the string no longer 
exists in the file, 

CAN NOT LOCATE "String" 

wl*U appear on the video display screen. This function is used to quickly 
locate selected areas within a file. 



SEARCH and REPLACE 

This function is used to locate a string and replace it with another 
string. The old and new strings may be of different lengths. The way this 
is haridled is as follows: 

SEARCH STRING? Old string/Mew string/1? 

followed by a RETURN. 12 represents the number of times that the 
replacement is to occur and may be any decimal number. In the event that 
"Old string" only appears 8 times in the text (from the current cursor 
position), the screen will clear and display: 

LOCATED "Old string" 8 TIMES 

The actual replacement will have been made 8 times. If "Old string" occurs 
12 or more times in the text, 12 replacements will be made and the cursor 
will return to the file. All occurences of "Old string" can be replaced oy 
typing a number greater than the possible occurences of "Old str ing" at the 
end of the reply to the SEARCH STRING? question. For example: 

SEARCH STRING? Mr. Jones/Mr. Smith/9999 

The system will respond with: 

LOCATED "Mr. Jones" 14 TIMES 

Assuming "Mr. Jones" appears only 14 times \n the text. 
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CODED STRING .SEAR CH_t.5 

Strings may be also located where only a certain pattern .s required. 
Assuming a file consists of names and addresses of clients with a code 
prefix as follows: 

US1234KP 

Tom Jones 

15 E. 94th St. 

New York, N.Y. 10028 

UP1235LP 

Bill Smith 

3800 Ui I shire Blvd. 

Los Angeles, CA. 90016 

WS6784HL 

Elmer^Brown 

300 if. Vermont 

Los Angeles, CA. 90028 

SEARCH STRING? WS###4H 

will locate Tom Jones. Typing a control character (C) will then locate 
Elmer Brown. Note that [#] is a "don't care" character. Using this 
function, a selected mailing list can be produced. Othe.r uses might 
include lists of sales prospects with action dates to represent 
appointments, expirations, service dates, etc. Data can be selectively 
extracted from a file automatically using the coded string search function. 



REPEAT FUNCTION 

Most functions may be repeated any number of times as per the following 
examples: 

(R)C5j(D) will delete 5 characters. 

CR)C22JC3 will type 22 periods. 

(R)E3j(P) will print 3 times. 

The cursor will disappear whenever (R) is typed and will return after the 
nuraber of repeats are performed. In the event of a typing error, the 
cursor will return and nothing else will happen. This three part comaand 
is not visible on the screen. 

LOUER-CASE ENABLE 



l't you have installed the lower-case modifcation in your TRS-S0, 
SHIFT-BREAK will toggle the keyboard between upper-case only and 
upper/ lower case operation (normal typewriter). 



;•£ ELECTRIC PENCIL 
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SUB-SYSTEM COMMAND TAB LE ■ 

Within The Electric Pencil is a Sub-System Command Table that permits 
implementation of additional commands as well as the setting up of Print 
Values. (IO clears the video display screen and displays the Sub-System 
Command Table as "follows: 






TAPE 


READER 


R 


TAPE 


URITER 


W 


TAPE 


VERIFY 


V 


WORD 


NUMBER 


X 


RCRD 


NUMBER 


Y 


CLER 


AA CUR 


CAA 


CLER 


AB CUR 


CAS 


CLER 


SYSTEM 


CLR 


RGHT 


JUSTFY 


JO-1 


LINE 


SPACNG 


S1-5 


PAGE 


SPACNG 


A2-20 


PAGE 


LENGTH 


G1-72 


LEFT 


MARGIN 


MO- 100 


PAGE 


NUK3ER 


N1-255 


PRNT 


LENGTH 


P0-255 


LINE 


LENGTH 


L25-125 



While in this mode, the standard keyboard keys are used alone without the 
CONTROL key. The above commands are NOT Control Character Commands. 

When these commands are referenced in this text, they shall be enclosed in 
brackets, e.g. CA3, LB3, £53. All commands must be terminated with ENTER. 
The LEFT-ARROU key is used to backspace, and the BREAK key is used to leave 
the sub-system. Command entry errors are indicated with a question mark 
"?" on the video display screen. Note that some of the functions are 
abbreviated on the screen. 



CR3 TAPE READER 



To enter a file that is on cassette tape into the file area of Ihe Electric 
Pencil, first depress the Tape Reader command CR3, then run the cassette 
recorder to a little before the file starts on the tape, press the cassette 
recorder play button, and then hit ENTER. The cursor will disappear from 
the screen and reading will begin. When the file has been correctly read 
Wo memory, "READY" wilt appear on the screen. If there is an error in the 
tape, "TAPE ERROR" will appear. Uhen a file is read into The Electric 
Pencil, it is normally placed at the end of any material that may already 
exist in the file are3. If this is to be a new file, the file nr?a should 
be cleared. See CCLR3, CCAA] and CCAB3. If the incoming file is too long 
for the existing memory, "FILE AREA FULL" will appear on the screen. The 
partially loaded file uilt then be removed from the file area with no 
damage to the current file, if any. 
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QD TAPE fcJRITER 

To write a file onto cassette tape, first place the cursor to the position 
in the file from which you wish to urite. If the entire file is needed, 
then (3) should be used to place the cursor at the beginning of tile. (K) 
trill then bring cp the Sub-System Command Table. Depress [Ul, place the 
cassette recorder in Record node at a convenient location on the tape, and 
hit E^iTER. The cursor will disappear and writing will begin. When the 
file has been recorded onto tape, "WRITTEN" will appear on the screen. 
Rewind the recorder to a little before the location where the writing 
started and VERIFY. When working uith lengthy text, it is advisable to 
periodically write the file onto tape as a precaution against power 
failures which can destroy all material in the file area as well as The 
Electric Pencil itself. 



Q/J TAPE VERIFY 



CV3i is basically the same as CR'J except the file is not placed into the 
file area. It is, however, checked for correctness, and returns with 
"VERIFIED" if the tape is correct or with "TAPE ERROR" if it is not. A 
tape just written showing "TAPE ERROR" should be re-written uith CHj. 
Continual tape errors indicate faulty tape or a faulty cassette recorder. 

DQ UORD NUK3ER 

CXj will return the number of words that are in the file from the current 
cursor position. A word is defined as any amount of characters with at 
least one space at either end. A word nay be as short as one character or 
as long as one line. 

CY3 RECORD KUK3ER 

CY3 uill return the number of records that are in the file from the current 
cursor position. A record is defined as any block of text that is 
terminated by EMTER or FORM FEED (L) . A record may be as short as one 
character or as long as the entire file. A record is most nearly like a 

paragraph. 
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CLEARING COM MANDS 

The folloying clearing commands require three characters to be entered by 
tho user as a precaution against accidental destruction- of the file area. 
These commands should be used with caution since any material in the file 
area cannot be retrieved once it has been erased. Back-up copies of text 
should always be made of files before text is cleared. 

CCAA] CLEAR ALL AFTER CURSOR 

CCAA3 will clear all text in the file from the cursor position just prior 
to entering the Sub-System to the end of the file. Upon completion, the 
Sub-System is aborted and normal operation is resumed. 

CCA3] CLEAR ALL BEFORE CURSOR 

LCA331 will clear all text in the file from the cursor position just prior 
to entering the Sub-System to the beginning of the file. The character 
under the cursor will not be cleared. Upon completion, the Sub-System is 
aborted and normal operation is resumed. 



LCLPJ CLEAR SYSTEM 

CCLR3 will clear the entire file area as well as reset all PRIMT VALUES to 
their DEFAULT VALUES. The video display screen uill clear and display: 

THE ELECTRIC PENCIL (C) 1978 MICHAEL SHRAYER 

CCLRl as well as CCAAD and CCABJ should be used uith care. 

SETTING UP PRINT VALUES 

The following PRINT VALUES are automatically set to DEFAULT VALUES when The 
Electric Pencil is first entered or when CCLRj is used. Whenever a command 
is entered without a value and is followed by a RETURN, the system assumes 
the DEFAULT VALUE for that command. 

[S3 RIGHT JUSTIFY DEFAULT V A LUE=0 

CJ03 (zero) sets the system to print as many characters on a line as will 
fit without justifying the right-hand margin of the text. C J 1 3 tells the 
system to calculate the number of characters in a line and expand the text 
so that the right-hand margin is justified (even). This is accomplished by 
inserting additional blank spaces between uords. Hyphenation is normally 
not required using [J13. 
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LSI LINE SPACING DEFAULT VALUE=1 



CS11 through CSS "1 sets the number of blank Lines between text lines that 
will appear in printing (single spacing, double spacing, etc.). CSXU 
inhibits transmission of line-feed characters during printing, as required 
by certain printers (see section on Printing, page 19). 

CA3 PAGE SPACING DEFAULT VALUE=12 

CA23 through CA203 sets the number of spaces (empty lines) between pages 
during printing. 

CG3 PAGE LENGT H DE FAULT VALUE=54 

EG ID through LG723 sets the number of lines of text that will appear on a 
page during printing. An empty line also counts as a line of text. 

CHI! LEFT MARGIN DEFAULT VALUE=0 



Ci-iOIl through CM100j sets the position of the left margin. This \/3lue added 
to LINE LENGTH must not exceed the carriage width of the printer. 



CN3 PAGE NUMBER DEFAULT VALUE=1 



LH11 through CN2551 sets the first page number to be used during printing. 
This assumes that pagenation has been set up. The highest page number 
available is 255 and then the system resets to 0, ', 2, etc. 

IP 1 PRINT LENGT H DEFAULT V ALUE=0 

CP02 enables printing of all the text from the cursor position to the end 
of the file. CP1] through CP255D sets the number of records that will be 
printed from the cursor position onward. 

CL3 LINE LENGTH DEFAULT VALUE=62 



CjL25j through CL1253 sets the number of characters per line of text that 
uill be printed. Using justification, extra spaces are added to each Line 
to maintain the total equal to the selected value. At the DEFAULT VALUE, 
the Line length uill be the same as that which appears on the video display 
screen,, and if justification is not selected, the text will be printed 
exactly as it appears on the screen. 



> rr-r::'; r - 
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(P) commands The Electric Pencil to start printing text from the current- 
cursor position forward. The amount of text that will be printed is 
governed by the setting of Print Length [Pi in the sub-system. The format 
that the printed page will assume is determined by the Prim Values set up 
by the user prior to printing. Printing may be repeated in order to obtain 
multiple copies of text by using the Repeat Command (R) . 

Two printer interfaces are supported, the standard Radio Shack expansion 
interface and the Small System Hardware TRS232 printer interface. The 
software automatically selects the printer the first_time the print command 
is typed. If you have the Radio Shack expansion interface^, be sure the 
printer is turned on b efore you type (P) ! Failure to do so will cause 
selection of the TRS232. If this happens, type BREAK, save your file on 
tape, reload The Electric Pencil, reload your file and continue. 

Page Spacing [A3 in the sub-system will determine the number of lines 
between pages. Manually advance the paper to the location where you wish 
printing to actually start on the paper. The cursor is then placed over 
the first character of text desired, and (P) is typed. Printing will 
begin. Printing may be controlled by using the SPACE BAR, ENTER and BREAK 
as in scrolling. You will have to hold these keys down until the printer 
reaches the end of a line to stop printing. 



PRINTE R CO MPATIB ILITY 

Some RS--252 printers require fill characters (nulls) after each carriage 
return to allow time for the carriage to reach the home position. If, for 
example, your printer requires 5 fill characters (see your printer manual), 
you may select these by entering the command CF5J uhere the 5 may be from 
0-255. Note that this special command is NOT displayed on the right of the 
screen. 



The Electric Pencil will operate RS-232 printers through the TRS232 at 300 
baud. If your printer requires a different baud rate, refer to 
documentation furnished with the TRS232 for instructions to modify the baud 
rate. 

Some printers, including Selectric models, will double-space when LS13 has 
been selected. This is caused by an automatic line-feed when a carriage 
•return is executed, followed by a second line-feed when the line-feed 
character is transmitted. To correct this condition, type CSX], which 
inhibits transmission of line feed characters to the printer. Once the 
CSK3 command has been typed, it cannot be reversed. If you accidentally 
enter this command, you will have to reload The Electric Pencil to restore 
line feeds. 
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TITLING PAGES and PAGE NUMBERING 

Pages may have title headings as in this manual by entering the following 
information at the beginning of the file onto the video display screen: 

Sir, is is a Sample Title Heading CENTER] 

Mote that in the above example a dollar sign [S3 MUST precede the title and 
CENTER] MUST be typed after the title text. In order for the title to 
appear in printing as a title, printing MUST start with the cursor directly 
over the dollar sign [S3. Otherwise, the title will be printed as regular 
text. If the title length is greater than the Line Length CL3 minus 10 
selected in the sub-system, the title text will appear on the printed page 
as regular text. Whenever a title heading is used, pages will be 
automatically numbered at the extreme top right of each page as they appear 
in this manual. If only page numbering is desired without a page title, 
only the dollar sign LSI immediately followed by ENTER is used. Printing 
must also begin directly over the [S3. In the course of printing, title 
headings may be changed by placing additional title headings (using the 
aboi/e form) into the text. The Electric Pencil will recognize these ONLY 
if they appear directly after a FORM FEED (L) . The new title heading will 
then appear on all subsequent pages till the end of printing, unless still 
another title is inserted after a FORM FEED. Page numbering will remain 
sequential throughout. The starting page number' will always be 1 unless 
set otherwise in the sub-system. 

UNDERLINING 

Underlining is possible only after installation of the modifciation kit 
allowing lower-case characters. You cannot underline if you are using a 
printer which does not have separate carriage return and line feed control, 
thus underlining is not possible on most Selectric printers. Words or 
phrases may be underlined ONLY in lines shorter than 62 characters 
terminated by ENTER. Underlining is not permissable within justified text. 
Text is underlined by entering the following onto the video display screen 
(use SHIFT-CLEAR to enter the underline character): 

CENTER] 



THIS IS A i EST CENTER] will print: THIS IS A TEST 
CENTER] 



T^is is a NEU test CENTER] will print: This is a NEU test 



EXIT SYSTEM 

(0) is used to exit The Electric Pencil and return to BASIC. 



REGISTRATION 

Please fill out the registration form that appears on the last page of this 
manual so that your name will be placed on a mailing list to receive 
information of any up-dates as welt as improvements to The Electric Pencil. 
Happy Word Processing !!! 
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LOt;^ CASE HODI FIXATION IMSTRUCTIGrJS 

?o modi fiy. tho T3S-3G for lowcr-cooe operation uith the electric pencil, 
shcr^os cust fco made to the screen display memory ond to the keyboard* 
Y£"sos*o ore many uays to accomplish this cadif ieaticn and it is up to tlio 
uacr to determine tho most satisf actory approach. The nod i fi cat 'ion 
requires changes to the circuit boards within the keyboard enclosure of 
your "i;T:3-30, thus your warranty uill be voided by this oodif i cat ion. We 
hove modified several computers ourselves and have had no difficulty with 
the TSS-SO after making the changes, however, HE CAMNOT ACCEPT 
RESPONSIBILITY FOR DARAGE TO YCUK COMPUTES CAUSES BY INSTALLATION OF THIS 
MODIFICATION « 



SCttcEM KEKORY K ODIFICATIO?J 

The T.TS-80 video display uses a dedicated block of 1024 byfis of s.e:aory 
located in memory space at 3 COO Hex. Uhen received from the factory, there 
ard^only 7 memory chips installed in this block of memory, providing 123 
possible characters for screen display. The stock THS-8G uses 64 of these 
combinations for graphics and a second 64 for the upper-case subset of the 
ASCII character set. Bits 0-5 control the character selection, and the 
highest bit (bit 7) is used to determine if the character is alpha-numeric 
or graphic- Bit 6 is missing! 

To add louer-case display, bit 6 oust be implemented. This nay be 
accomplished by suitching the memory chip for bit 7 to bit 6, thereby 

enabling louer-case letters and eliminating graphics,, or by addition of an 
0th memory chip, tie prefer adding the extra chip* In either case,, if you 
plan to use Level II Basic, you must includo a suite to to disable bit 6, or 
Basic uill place a lot of funny characters on the screen! 

Refer to the top portion of the figure on page 23. A lou-power 2102A 
memory chip (available at most electronic stores) is piggy-backed onto en 
existing 21G2A, and appropriate connections ore made. Take the r/?u 21Q2A, 
carefully bend pins 11 and 12 up from their normal position, then slide the 
chip doun over the 2102 located at position 245 on the larger of the two 
TfiS-GO circuit boards (tho 2-nunber is printed en the circuit board next to 
coca chip). Be cure that the chip is oriented to place pin 1 en top of pin 
12 Uhen all pins arc aligned and contacting (except 11 and 12, of course)., 
carefully solder each ox the 14 pins from the added chip to the chip on tho 
circuit board, fork quickly but be cure you got o good colder joint! Kou^ 
cow: oct a sou 1 1 piece of insulated wire (uire-urcp uiro is ideal) to pin 
111 „ Locate pin 13 on chip 244, and attach the other end of the aire to the 
pad uhicb is connected to this pin. 

Detueen chips Z29 and Z30 there are three traces, tuo uide and one narrow. 
Cut the narrou trace with a sharp knife. Attach tuo pieces of insulated 
wire to each of the cut ends of this trace, and a third piece to pin 12 of 
the added memory chip. Run these three uires to a single-pole double-thro*;,' 
cult eh as shown in the diagram. This suitch changes the screen memory from 
tho original 7-bit configuration to the neu 8 bit configuration, thus 
allowing you to suitch back and forth between Basic and Tho Electric 
Ponci I . 
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KEYBOARD MODI FT CATION 

One change roust be made to the keyboard; a CONTROL key must bo added. It 
is possible to isolate and use one of the present keyboard keys (such as 
the doun-arrou) as a CONTROL key, but we recommend adding another key.. 

Install your new control key, or isolate one of the existing keys by 
cutting the traces on the keyboard circuit board. Locate 12 and Z4 on the 
loner-left of the circuit board. Attach wires to pin 4 of 12 and pin 10 of 
Z-'> (these wires may be attached to the top or bottom of the circuit board, 
as desired). Attach the other ends of these wires to the control key. Be 
sure you leave enough slack in the wires to allow re-assembly of your 
computer. This completes installation of the lower-case modification. 

IMPORTANT: There are at least two different keyboards used on the TRS-80 
computer. One of these is green and has traces on both sides of the board, 
while the other is tan and has printed traces on only one side. If you 
have the tan board, you may have to attach one of the control key wires to 
chfi'p Z2 Pin 10 instead of Z2 pin 4. This may be verified by tracing either 
of the above pins to the shift key. Attach the wire to the same pin that 
connects to the shift key. 

This modification will work only with The Electric Pencil! To enable 
louer-case entry, type SHI FT-BREAX . The keyboard will now operate as a 
normal typewriter, entering louer-case characters unless the shift key is 
depressed. If you type a second SHIFT-BREAK, the keyboard will return to 
upper-case only operation. * 

The lower-case character set for the TNS-SO will appear strange. In most 
cases, the small 'a' is raised above the line. All of the characters which 
normally extend below the line (g,j,P,q,y> will also be seen in a raised 
position. Of course, wh^n these characters are printed their appearance 
will depend only upon the printer character set. 
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DIAGRAM OF TRS-80 LOWER-CASE MODIFICATION 
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